package cn.iocoder.yudao.module.api.product.spu;

import cn.iocoder.yudao.framework.business.basic.pojo.dto.LocationQueryDTO;
import cn.iocoder.yudao.framework.business.basic.pojo.dto.SortQueryDTO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.api.product.spu.dto.ProductSpuDetailRespDTO;
import cn.iocoder.yudao.module.api.product.spu.dto.ProductSpuForUniAppRespDTO;
import cn.iocoder.yudao.module.api.product.spu.dto.ProductSpuPageReqDTO;
import cn.iocoder.yudao.module.api.product.spu.dto.ProductSpuRespDTO;
import jakarta.validation.Valid;

import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;

/**
 * 产品 SPU API 接口
 *
 * @author LeeYan9
 * @since 2022-08-26
 */
public interface ProductSpuApi {

    /**
     * 批量查询 SPU 数组
     *
     * @param ids SPU 编号列表
     * @return SPU 数组
     */
    List<ProductSpuRespDTO> getSpuList(Collection<Long> ids);

    /**
     * 批量查询 SPU MAP
     *
     * @param ids SPU 编号列表
     * @return SPU MAP
     */
    default Map<Long, ProductSpuRespDTO> getSpuMap(Collection<Long> ids) {
        return convertMap(getSpuList(ids), ProductSpuRespDTO::getId);
    }

    /**
     * 批量查询 SPU 数组，并且校验是否 SPU 是否有效。
     *
     * 如下情况，视为无效：
     * 1. 产品编号不存在
     * 2. 产品被禁用
     *
     * @param ids SPU 编号列表
     * @return SPU 数组
     */
    List<ProductSpuRespDTO> validateSpuList(Collection<Long> ids);

    /**
     * 获得 SPU
     *
     * @return SPU
     */
    ProductSpuDetailRespDTO getSpuDetail(Long id);

    /**
     * 获得 SPU
     *
     * @return SPU
     */
    default ProductSpuRespDTO getSpu(Long id) {
        return getSpuDetail(id);
    }

    /**
     * 获得产品 SPU
     *
     * @return SPU
     */
    ProductSpuRespDTO validateSpu(Long id);

    /**
     * 浏览产品 SPU（适配 UNI-APP SKU 组件）
     *
     * @param userId 用户编号
     * @param id     编号
     * @return SPU
     */
    ProductSpuForUniAppRespDTO browseSpu(Long userId, Long id);

    /**
     * 获得产品 SPU 分页，提供给短视频、店铺等其他模块使用
     *
     * @param dto 分页查询
     * @return 产品 SPU 分页
     */
    PageResult<ProductSpuRespDTO> getSpuPage(@Valid ProductSpuPageReqDTO dto);

    /**
     * 获得产品 SPU 总数
     * @param shopId 店铺编号
     * @return 产品 SPU 总数
     */
    Long getProductCountByShopId(Long shopId);

    /**
     * 批量查询 SPU 数量 MAP
     *
     * @param shopIds 店铺编号列表
     * @return SPU 数量 MAP
     */
    Map<Long, Integer> getSpuCountMapByShopIds(Collection<Long> shopIds);

    /**
     * 根据指定行业类目编号获取有产品的店铺编号及距离
     *
     * @param pcIds 行业类目编号集合
     * @param location 经纬度
     * @param sort 排序
     * @return 店铺编号集合
     */
    Map<Long, Integer> getShopDistanceMapByPlatformCategoryIds(Set<Long> pcIds, LocationQueryDTO location, SortQueryDTO sort);

}
